home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / wb-tools / background / background.dok < prev    next >
Text File  |  1996-03-17  |  7KB  |  221 lines
  1. Document Background
  2.  
  3.                                     Background v1.32
  4.  
  5. Background und dieser Text sind Copyright © 1996 Roland Haas
  6.  
  7.  
  8.  
  9. 1. Copyright&Rechtliches
  10. ========================
  11.  
  12. Vertrieb
  13.  
  14. Background darf frei vertrieben werden, solange der Inhalt des Archivs
  15. komplett weitergegeben wird. Außerdem darf nur eine Gebühr für den
  16. Arbeits- und Materialaufwand verlangt werden.
  17.  
  18. Background darf mit frei kopierbarer Software vertrieben werden, solange die
  19. oben genannten Bedingungen erfüllt sind. Der Vertrieb zusammen mit einem
  20. kommerziellen Programm ist nur mit ausdrücklicher, schriftlicher Genehmigung
  21. des `Autor's erlaubt.
  22.  
  23. Gewährleistung
  24.  
  25. Es wird keine Haftung für Schäden übernommen, die dieses Programm verursacht,
  26. selbst wenn der Autor davon gewußt hätte.
  27.                 SIE BENUTZEN DIESES PROGRAMM AUF EIGENES RISIKO
  28.  
  29. 2. Einführung
  30. =============
  31.  
  32. Was ist "Background"?
  33.  
  34. Background ist ein Programm ähnlich den NickPrefs von Nicola Salmoria. Anders
  35. als bei NickPrefs WBPICTURE kann jedoch jedem einzelnen Workbenchfenster ein
  36. eigenes Bild zugeordnet werden.
  37.  
  38. Weshalb?
  39.  
  40. Background wurde geschrieben, weil ich zu diesem Zeitpunkt keine Möglichkeit
  41. hatte an NickPrefs heranzukommen. Als ich dann NickPrefs hatte reichten mir
  42. die Möglichkeiten nicht aus. Da ich nicht weiß, ob ein ähnliches Programm
  43. existiert, habe ich eben mein eigenes geschrieben.
  44.  
  45. 3. Systemvoraussetzungen
  46. ========================
  47.  
  48. Zwingend benötigt werden:
  49.  
  50.  · mindestens OS 2.0
  51.  · IFFPARSE.library in LIBS:
  52.  
  53. Nicht erforderlich, aber empfehlenswert sind:
  54.  
  55.  · 1 MBYTE Chip-RAM
  56.  · Festplatte
  57.  
  58. 4. Installation
  59. ==============
  60.  
  61. Kopieren Sie als erstes das Programm Background in die WBSTARTUP Schublade.
  62. Dann starten Sie einen Texteditor und erstellen die Datei
  63. "ENVARC:Background.conf". ("ed envarc:Background.conf" in einer Shell eingeben)
  64. Genaueres zum Aufbau dieser Datei finden sie in `Konfiguration'. Nachdem Sie
  65. die Datei erstellt haben, führen Sie entweder einen Neustart durch oder
  66. kopieren die Datei von ENVARC: nach ENV:
  67.  
  68.  
  69. 5. Konfiguration
  70. ================
  71.  
  72. Background erhält die Informationen zu den Fenstern aus der Datei
  73. ENV:Background.conf. Das Betriebssystem kopiert diese Datei während des
  74. Bootvorgangs von ENVARC: dorthin. Das hat zur Folge, daß Sie, um dauerhafte
  75. Änderungen vorzunehmen immer die Datei in ENVARC: verändern müssen und sie
  76. dann anschließend nach ENV: kopieren müssen. Lesen Sie dazu auch `Zukünftiges'.
  77.  
  78.  
  79. 5.1. Die Datei Background.conf
  80.  
  81. Die Datei muß folgenden Aufbau haben:
  82.  
  83. Erste Zeile  : Pfad_zu_einem_Bild,TILE/S
  84. Zweite Zeile : Pfad_zu_einem_Bild,TILE/S
  85. Übrige Zeilen: Pfad_zu_einem_Bild,Erkennungsmuster,TILE/S
  86.  
  87.  
  88. Pfad_zu_einem_Bild bezeichnet dabei das IFF-Bild, das als Hintergrund dient.
  89.  
  90. Wird TILE angegeben, dann wird das Bild als Muster verwendet, das so oft
  91. aneinandergesetzt wird wie nötig. Dabei muß natürlich die untere Kante an die
  92. obere und die linke an die rechte passen. Wird TILE dagegen weggelassen, wird
  93. alles, was nicht vom Bild bedeckt wird mit der Hintergrundfarbe (grau) gefüllt.
  94.  
  95. Das Erkennungsmuster ist ein DOS-Muster, das angibt, für welche Fenster das
  96. Bild verwendet werden soll. Mögliche Muster sind zum Beispiel:
  97.  
  98. (Prefs|Presets)                      - die Schubladen Prefs und Presets
  99. Pictures.~(HAM)                      - alle Pictures. Schubladen außer der
  100.                                              Schublade Pictures.HAM
  101. "#? % voll, #? frei, #? belegt" - alle Diskettenfenster
  102.  
  103. Beachten Sie die Anführungszeichen um das letzte Muster, sie sind nötig, weil
  104. das Muster Leerzeichen enthält.
  105.  
  106.  
  107. 5.1.1. Die Bedeutung der Zeilen
  108.  
  109. Die einzelnen Zeilen haben folgende Bedeutung:
  110.  
  111. Zeile 1: Gibt an, welches Bild verwendet werden soll, falls keines der Namens-
  112.             muster paßt.
  113.  
  114. Zeile 2: Diese Zeile muß nicht zwingend vorhanden sein. Wenn vorhanden, gibt
  115.             sie an, welches Bild verwendet werden soll, wenn das Fenster keinen
  116.             Titel hat. Dies trifft z.B. auf das Workbench Hauptfenster zu. (Nur
  117.             wenn "Backdrop" angewählt ist)
  118.  
  119. Andere : Legen fest, daß für Fenster, auf deren Titel das Erkennungsmuster
  120.             paßt, das Bild Pfad_zu_Bild verwendet werden soll. Paßt ein Fenster-
  121.             name auf mehrere Muster, dann wird das Bild, das zuletzt angegeben
  122.             wurde verwendet. Sieht die Background.conf folgendermaßen aus,
  123.  
  124.             dh0:Gfx/Pix/Back1 "#? % voll, #? frei, #? belegt" TILE
  125.             dh0:Gfx/Pix/Game    #?Spiele#? TILE
  126.  
  127.             dann wird für das Fenster "Spiele 50 % voll, 24 M frei, 24 M belegt",
  128.             das Bild "dh0:Gfx/pix/Game" verwendet.
  129.  
  130. 5.2. Beispiel
  131. =============
  132.  
  133. Work:gfx/Pix/Back1 TILE ;Standartbild für alle, für die sonst nichts paßt
  134. Work:Gfx/Pix/Romantique ;Workbenchfenster
  135. Work:Gfx/Pix/Disks "#? % voll, #? frei, #? belegt" TILE ;Alle Disketten
  136. Work:Gfx/Pix/Back2 (Prefs|Presets|Devs|System) TILE ;Systemschubladen
  137.  
  138.  
  139. 6. Starten
  140. ==========
  141.  
  142. Background kann sowohl vom CLI als auch von der Workbench aus gestartet werden.
  143. In beiden Fällen kann das Schlüsselwort NOSCAN angegeben werden. Dieses
  144. Schlüsselwort verhindert, daß Background den Hintergrund schon offener
  145. Fenster ändert.
  146.  
  147. CLI: background NOSCAN/S
  148. WB:  NOSCAN als Tooltype
  149.  
  150.  
  151. 7. Zukünftiges
  152. ==============
  153.  
  154. Sicher implementiert:
  155.  
  156.     · Voreinstellungseditor à la NickPrefs
  157.     · Ändern der Bilderliste ohne das Programm neuzustarten
  158.  
  159. Wahrscheinlich implementiert:
  160.  
  161.     · Programmgröße und Speicherverbrauch verringert
  162.  
  163. Vorschläge bitte an den `Autor'.
  164.  
  165. 8. Danksagungen
  166. ===============
  167.  
  168. Dank an folgende Leute, ohne die ich dieses Programm nie geschrieben hätte:
  169.  
  170. David Benn : Für seinen ACE Compiler, mit dem dieses Programm geschrieben
  171.                  wurde. Siehe auch `Geschichte'.
  172.  
  173. Meinem Bruder : Niemand findet so viele Fehler ;-)
  174.  
  175. Nicola Salmoria : Für die Nickprefs, die mich auf die Idee brachten das
  176.                         Programm zu schreiben.
  177.  
  178. 9. Bekannte Fehler
  179. ==================
  180.  
  181.     · Bei sehr kleinen Bildern (<64x64) stürzt das Programm ab
  182.       Workaround: Bild mit DPAINT aneinandersetzen
  183.  
  184.     · Kein richtiger Fehler: Es ist _nicht_ möglich einen Patch sicher aus dem
  185.       System zu entfernen.
  186.  
  187.     · Wird Background gestartet, bevor die Workbench läuft tut sich gar nichts
  188.  
  189. 10. Autor
  190. =========
  191.  
  192.     Wer einem armen Schüler eine kleine Spende für seine Mühe zukommen lassen
  193.     will, der schicke Geld, Programme etc. an :
  194.  
  195.  
  196.         Roland Haas
  197.         Mühlweg 16
  198.         77948 Friesenheim
  199.         Deutschland
  200.  
  201.         Telefon: 07821/68084
  202.  
  203. 11. Geschichte
  204. ==============
  205.  
  206. Die Anfänge des Programms sind mir selbst unbekannt, es begann alles
  207. irgendwann im November '95 mit einer Laderoutine für IFF-ILBM Bilder.
  208. Hier die dokumentierten Ereignisse seit dem 20 Januar '96:
  209.  
  210.  20.01.1996: V1.15 Lauffähige Version (na ja fast)
  211.  20.02.1996: V1.20 Mungwall-hit und andere Unstimmigkeiten
  212.  24.02.1996: V1.21 Noch'n Mungwall-hit
  213.  25.02.1996: V1.25 MatchWin und TestHook jetzt Assembler
  214.  05.03.1996: V1.30 ViewPic nach Assembler
  215.  09.03.1996: V1.31 Kleinere Fehler in CleanExit
  216.  16.03.1996: V1.32 Fehler bei der Erkennung des aufrufenden Tasks
  217.  
  218. Ab V1.25 sind die Routinen, die vom System aufgerufen werden in Assembler
  219. geschrieben (A68k).
  220. Ab V2.0 wird wahrscheinlich das gesamte Programm Assembler sein.
  221.